Release 10.1A: OpenEdge Application Server:
Developing WebSpeed Applications

url-format

This function formats a URL and arguments for all the specified fields that result in non-blank values. It returns a series of name\value pairs suitably encoded and delimited to send to a browser.

Location: web\method\cgiutils.i

Parameters:

INPUT p_url AS CHARACTER

A URL without arguments or query strings. If a Unknown value (?) is specified for the URL, the value of the global variable SelfURL is used, which is the URL of the currently executing Web object without the host name and port number.

INPUT p_name-list AS CHARACTER

A character expression containing a comma-delimited list of field names available through the get-value function.

INPUT p_delim AS CHARACTER

The delimiter to use between name\value pairs. If the Unknown value (?) is specified, the default is & which is appropriate if the resulting URL is output to the browser.

Returns: CHARACTER

Notes: The value associated with each field name is determined by calling the get-value API function.

Examples:

{&OUT} url-format("custdetail.html","name,custnum",?).

See also:

url-field-list

get-value

url-field

hidden-field-list